Skip to content

feat: Support OpenAPI 3.1.x - #1231

Open
ZhongpinWang wants to merge 32 commits into
mainfrom
support-openapi-3.1
Open

feat: Support OpenAPI 3.1.x#1231
ZhongpinWang wants to merge 32 commits into
mainfrom
support-openapi-3.1

Conversation

@ZhongpinWang

@ZhongpinWang ZhongpinWang commented Jul 21, 2026

Copy link
Copy Markdown

Context

This is a generated (later manually reviewed and fixed) PoC for evaluating the effort of supporting OpenAPI 3.1.x in the generator.

The following two files coming from the initial round of generation might be outdated but you can use as a reference.

  • Check the OAS31_GAPS.md for the gaps evaluated.
  • Check the OAS31_CHANGES.md for the actual changes generated.

I generated all data models in AI SDK Java with the new SNAPSHOT cloud sdk generator, and there were no breaking changes.

See SAP/ai-sdk-java#958 for the generated result.

@CharlesDuboisSAP CharlesDuboisSAP left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some test coverage is lacking, you could add some more unit tests

@ZhongpinWang
ZhongpinWang marked this pull request as ready for review July 23, 2026 13:42

@CharlesDuboisSAP CharlesDuboisSAP left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall LGTM, one small thing:
Why did you duplicate all integrations tests in DataModelGeneratorApacheIntegrationTest? I would remove them since they are already tested in DataModelGeneratorIntegrationTest, and they cover the same lines of code, apache only changes the inside of the Api class which are not the point of your tests anyway.

@ZhongpinWang ZhongpinWang changed the title feat: (PoC) Support OpenAPI 3.1.x feat: Support OpenAPI 3.1.x Jul 30, 2026
@ZhongpinWang

Copy link
Copy Markdown
Author

@CharlesDuboisSAP @Jonas-Isr Can you add a simple release note for this? I don't know how you do this normally in Java team.

@ZhongpinWang

Copy link
Copy Markdown
Author

I added a log warning for 3.1 to point out that this is an experimental feature. We can remove this after a while.

Comment thread datamodel/openapi/openapi-generator/pom.xml.bak Outdated
Comment thread datamodel/openapi/openapi-generator/pom.xml

@CharlesDuboisSAP CharlesDuboisSAP left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, let's wait for @Jonas-Isr's review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants